home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / os20 / wb / toolmanager2_0.lha / ToolManager / Docs / TM_English.doc < prev    next >
Text File  |  1992-09-26  |  48KB  |  1,369 lines

  1.  
  2. ToolManager 2.0 Documentation
  3. ******************************
  4.  
  5.  
  6. Copyright and other legal stuff
  7. ********************************
  8.  
  9.    Copyright (C) 1990-92 Stefan Becker
  10.  
  11.    Permission is granted to make and distribute verbatim copies of this
  12. manual provided the copyright notice and this permission notice are
  13. preserved on all copies.
  14.  
  15.    No guarantee of any kind is given that the programs described in
  16. this document are 100% reliable. You are using this material at your
  17. own risk. The author *can not* be made responsible for any damage which
  18. is caused by using these programs.
  19.  
  20.    This package is freely distributable, but still copyright by Stefan
  21. Becker. This means that you can copy it freely as long as you don't ask
  22. for a more than nominal copying fee. This fee *must not* be more than
  23. US $5 or 5 DM.
  24.  
  25.    *This limit applies to German Public-Domain dealers too!!*
  26.  
  27.    Permission is granted to include this package in Public-Domain
  28. collections, especially in Fred Fishs Amiga Disk Library (including CD
  29. ROM versions of it). The distribution file may be uploaded to Bulletin
  30. Board Systems or FTP servers. If you want to distribute this program
  31. you *must* use the original distribution archive `ToolManager2_0.lha'.
  32.  
  33.    None of the programs nor the source code (nor parts of it) may be
  34. included or used in commercial programs unless by written permission
  35. from the author.
  36.  
  37.    *None* of the programs *nor* the source code (nor parts of it) may
  38. be used on any machine which is used for the research, development,
  39. construction, testing or production of weapons or other military
  40. applications. This also includes any machine which is used for training
  41. persons for *any* of the above mentioned purposes.
  42.  
  43.  
  44. Important notes
  45. ****************
  46.  
  47.    Welcome to the wonderful world of ToolManager 2.0 :-)
  48.  
  49.    - ToolManager and its concepts have drastically changed (see History)
  50.      since the last release (1.5).
  51.  
  52.    - Starting with the ToolManager 2.0 release, this program has a
  53.      *GiftWare* option. If you like the program and use it very often,
  54.      you should consider to send a little donation to honor the work
  55.      that the author has put into this program. I suggest a donation of
  56.      US $10-$20 or 10-20 DM. Please don't send cheques or money orders
  57.      from outside Europe, because most often cashing those items costs
  58.      more than what they amount to.
  59.  
  60.      If you don't send the donation or can't afford it, you needn't
  61.      feel bad about it. Please send me a note saying that you are using
  62.      ToolManager anyway (I like to get fan mail :-). See Authors
  63.      address.
  64.  
  65.    - Users of ToolManager 1.X can start with the quick installation
  66.      chapter (see Quick installation). Some features haven't changed
  67.      and the rest is fairly easy to find out by trial & error. For a
  68.      detailed description of the new concept & features browse the
  69.      reference part of this document (see Objects).
  70.  
  71.      You *must* remove any running ToolManager 1.X or the new version
  72.      won't work. The new version cannot read the old configuration file
  73.      format (Sorry).
  74.  
  75.    - First-time users should read the entire document to understand the
  76.      concept and purpose of the program. Start with Introduction.
  77.  
  78.    - ToolManager 2.0 uses some features of AmigaOS Release V38, which
  79.      should (hopefully) be available to all Amiga users by the time you
  80.      read this. But if you are still using Release 2.0 (referred to as
  81.      V37 in this document), you need not worry since ToolManager doesn't
  82.      rely on these features. All extended V38 features are marked in
  83.      this documentation.
  84.  
  85.  
  86. Where to send bug reports, comments & donations
  87. ************************************************
  88.  
  89.    The author can be reached at the following addresses:
  90.  
  91. Postal address:
  92.  
  93.                Stefan Becker
  94.                Holsteinstrasse 9
  95.           5100 Aachen
  96.                GERMANY
  97.  
  98. InterNet Electronic Mail:
  99.  
  100.           stefanb@pool.informatik.rwth-aachen.de
  101.  
  102.  
  103. How to install ToolManager 2.0 the fast way
  104. ********************************************
  105.  
  106.    The basic ToolManager 2.0 installation consists of the following
  107. four parts:
  108.  
  109. `Libs/toolmanager.library' => `LIBS:'
  110.      This is the main program of ToolManager. It handles all programs,
  111.      menus, icons and docks (see Library).
  112.  
  113. `Prefs/ToolManager*' => `SYS:Prefs'
  114.      This is the editor for the configuration (see Preferences).
  115.  
  116. `WBStartup/ToolManager*' => `SYS:WBStartup'
  117.      With this utility you can start and stop ToolManager. If it
  118.      resides in the WBStartup drawer, ToolManager gets always loaded
  119.      when your machine boots up.
  120.  
  121. `L/WBStart-Handler' => `L:'
  122.      This program starts programs by the Workbench startup method. It
  123.      is a seperate process, so that you can quit ToolManager even if
  124.      you have still programs running that were started by it with the
  125.      WB method.
  126.  
  127.    After copying these files, you should quit any older version of
  128. ToolManager running on your machine and double-click the ToolManager
  129. icon in the WBStartup drawer. Now you can start the preferences editor
  130. and play around (Use the "Test" button instead of the "Use" button
  131. while testing). You should be able to figure out most features with
  132. trial & error, for further information look into the ToolManager object
  133. descriptions (see Objects).
  134.  
  135.  
  136. What is ToolManager?
  137. *********************
  138.  
  139.    ToolManager is a flexible program to manage the tools in your working
  140. environment. It can start Workbench and CLI programs as well as ARexx
  141. scripts. The user interface consists of menus, icons or dock windows.
  142. If you like a noisy computer, you can associate a sound to each of
  143. these items. See Sound.
  144.  
  145.    ToolManager can add items to the Workbench `Tools' menu. If you
  146. select such a menu item, the program associated with it will be
  147. started. Every selected icon on the Workbench will be used as an
  148. argument for the program. This feature is only available when the
  149. Workbench is running. See Menu.
  150.  
  151.    ToolManager can add icons to the Workbench window. When you
  152. double-click such an icon, the program associated with it will be
  153. started. If you drop some icons on this icon, the program will be
  154. started with these icons as arguments. This feature is only available
  155. when the Workbench is running. See Icon.
  156.  
  157.    ToolManager can create a dock window from a collection of programs.
  158. This window can be opened on every public screen. Each program is
  159. represented by an image or a button gadget. To start a program you
  160. simply click on the image or the button gadget. If the dock window has
  161. been opened on the Workbench screen and the Workbench is running, you
  162. can also drop some icons on the image or the button gadget to start the
  163. program with arguments. See Dock.
  164.  
  165.    Additionally you can assign a Hot Key to each program. If you press
  166. this Hot Key, the program will be started. Note that *no* arguments can
  167. be passed to the program if you use this startup method. See Exec.
  168.  
  169.  
  170. The concepts behind ToolManager
  171. ********************************
  172.  
  173.    ToolManager 2.0 uses a new object-oriented approach to provide a
  174. flexible and extendable system. This approach made it possible to
  175. enhance several ToolManager features of the 1.X versions, e.g. you can
  176. now have multiple docks.
  177.  
  178.    An object is a collection of data which describes its features. Each
  179. object has a name and a type. You can create as many objects of each
  180. type as you want, but the name of each object has to be unique, because
  181. it is used as a reference to this object.
  182.  
  183.    Currently there are six different types of objects: Exec, Image,
  184. Sound, Menu, Icon and Dock. The first three of them are basic objects;
  185. that means they don't reference other objects. They provide data or
  186. services for the complex objects.
  187.  
  188.    The last three object types are complex objects; that means they
  189. reference simple objects and rely on them to get access to data or
  190. services. The reference is done by name, and if no simple object with
  191. this name exists, the complex object will ignore it. Note that this may
  192. reduce the functionality of the complex object, e.g. an Icon object
  193. *needs* the data from an Image object, so if this object doesn't exist
  194. it won't create an icon.
  195.  
  196.    For a detailed description of all object parameters see Objects.
  197.  
  198.  
  199. Description of all files in the distribution
  200. *********************************************
  201.  
  202.    The ToolManager 2.0 distribution consists of several directories
  203. which are explained below.
  204.  
  205.  
  206. The Docs directory
  207. ===================
  208.  
  209.    This directory contains the documentation for ToolManager. The
  210. documentation is available in four different formats and several
  211. languages. Additionally there is a file in AutoDoc format describing
  212. the ToolManager shared library interface.
  213.  
  214. Prefix `TM_<language>'
  215.      This file contains the documentation for the specified language.
  216.      Currently available languages are: Deutsch, English, Svenska.
  217.  
  218. Postfix `.doc'
  219.      This file contains the documentation as plain ASCII text.
  220.  
  221. Postfix `.dvi'
  222.      This file contains the documentation in TeXs DVI format. To get a
  223.      printed manual, run this file through a TeX printer driver.
  224.  
  225. Postfix `.guide'
  226.      This file contains the documentation in AmigaGuide format.
  227.      Although it is only plain ASCII with some commands, you need
  228.      AmigaGuide to exploit the hypertext links in it. The author hopes
  229.      that AmigaGuide will be available soon to all Amiga users.
  230.  
  231. Postfix `.tex'
  232.      This file contains the documentation in Texinfo format, as
  233.      specified by the Free Software Foundation (FSF). Together with the
  234.      `texinfo.tex' macro package, you can use TeX and `texindex' to
  235.      create a file in DVI format (see above).
  236.  
  237. `toolmanager.doc'
  238.      This file contains the ToolManager shared library interface
  239.      description in AutoDoc format.
  240.  
  241.  
  242. The Goodies directory
  243. ======================
  244.  
  245.    This directory contains additional program packages which are useful
  246. for ToolManagers operation.
  247.  
  248. `GetPubName.lha'
  249.      This little program prints the name of the frontmost public screen
  250.      either to stdout or into an environment variable. It was written
  251.      by Michael "Mick" Hohmann.
  252.  
  253. `upd1_20.lha'
  254.      The program `upd' was written by Jonas Petersson. It is a small
  255.      program which opens an ARexx port and waits for commands. Via
  256.      ARexx you can order `upd' to play sampled files. ToolManager uses
  257.      this feature to implement its Sound objects. See Sound.
  258.  
  259.    Users of ToolManager 1.5 may wonder why the utility `DeleteTool' is
  260. missing in this release. This utility may be replaced by the program
  261. `BlackHole' on Fish Disk #662.
  262.  
  263.  
  264. The Graphics directory
  265. =======================
  266.  
  267.    This directory contains a rich collection of images from which you
  268. can choose your favourite ones. Just load them as Image objects into
  269. ToolManager (see Image).
  270.  
  271.    The files were contributed by various people (see Credits). Each of
  272. them got a seperate sub-directory in the distribution. As the files were
  273. created by different authors, they come from different environments
  274. (palette, depth, resolution, size) and have different design styles. So
  275. not all images may look good on your machine.
  276.  
  277.    To differentiate the image formats that are supported by
  278. ToolManager, each file has a postfix which describes the file format:
  279.  
  280. `.anmb'
  281.      This is an IFF ANIM file created by a paint/animation program. It
  282.      can contain several pictures. Although ToolManager can load
  283.      complete ANIM files, you must use something like DPaints
  284.      "AnimBrush" feature to cut out the interesting part of the
  285.      animation.
  286.  
  287. `.brush'
  288.      This is an IFF ILBM file created by a paint program. It contains
  289.      only one image.
  290.  
  291. `.info'
  292.      This is a normal Amiga Icon created with IconEdit (or something
  293.      similiar). It can contain two images.
  294.  
  295.  
  296. The L directory
  297. ================
  298.  
  299.    This directory contains only one file, namely `WBStart-Handler'. You
  300. *must* copy this file to the `L:' directory, or otherwise ToolManager
  301. won't be able to start any Exec objects by the WB startup method (see
  302. Exec).
  303.  
  304.    The complete package WBStart 1.2 may be found on a Fish Disk.
  305.  
  306.  
  307. The Libs directory
  308. ===================
  309.  
  310.    This directory contains only one file, `toolmanager.library'. This
  311. is the main program for ToolManager and must be copied to the `LIBS:'
  312. directory.
  313.  
  314.  
  315. The Locale directory
  316. =====================
  317.  
  318.    This directory contains all files for ToolManagers Locale support. As
  319. locale.library is new with V38, you need not copy these files if you are
  320. using V37. If you are using V38, choose the files for your language and
  321. copy them to the appropriate places.
  322.  
  323. `Catalogs/<language>/toolmanager.catalog'
  324.      This is a translation file for the specified language. Copy the
  325.      file for your language to the directory
  326.      `LOCALE:Catalogs/<language>'.
  327.  
  328. `Languages/<language>.language'
  329.      Some languages are not supported by the standard V38 Locale
  330.      distribution. So some of the translators have supplied a
  331.      `.language' file, so that ToolManager can use their translation
  332.      files. Copy the file for your language to the directory
  333.      `LOCALE:Languages'. Additional available languages are: Finnish
  334.      (suomi), Eefeler Platt (eifel).
  335.  
  336.  
  337. The Prefs directory
  338. ====================
  339.  
  340.    The ToolManager preferences editor and its icon reside in this
  341. directory. Copy both files to the directory `SYS:Prefs'. For further
  342. information on the editor see Preferences.
  343.  
  344.  
  345. The Programmers directory
  346. ==========================
  347.  
  348.    This directory contains all files which are needed by the various
  349. computer languages and their compilers to use the ToolManager shared
  350. library interface. Look into the sub-directory `examples' for some
  351. examples on how to use this interface. For a complete interface
  352. description read the file `Docs/toolmanager.doc'.
  353.  
  354.    Currently supported languages/compilers are: AmigaOberon, DICE C,
  355. M2Amiga Modula, MANX Aztec C and SAS C.
  356.  
  357.  
  358. The Scripts directory
  359. ======================
  360.  
  361.    This directory contains a collection of ARexx or Shell scripts which
  362. can be used in ToolManagers Exec objects. Note that they may be
  363. specific to the authors environment or shell, so you may have to modify
  364. them.
  365.  
  366.  
  367. The Source directory
  368. =====================
  369.  
  370.    This directory contains the complete source code to ToolManager 2.0
  371. and its utilities. Each program has its own sub-directory. The author
  372. provides the source code as an example for OS 2.0 programming.
  373.  
  374.    The `locale' sub-directory is of interest for translators. If your
  375. language is not supported in this release and you want to do the
  376. translation, look at the file `empty.ct'. Just fill in the empty lines
  377. and send the file to me. Maybe it will be included in the next release.
  378.  
  379.  
  380. The WBStartup directory
  381. ========================
  382.  
  383.    Only one program resides in this directory: `ToolManager'. This
  384. utility starts and stops ToolManager 2.0. Most of the time this utility
  385. will reside in the `SYS:WBStartup' directory, but it can be used from
  386. the Shell too.
  387.  
  388.  
  389. ToolManager objects reference
  390. ******************************
  391.  
  392.    This chapter describes the ToolManager objects in detail. Each
  393. object has a type and a name. The name is used to reference the object.
  394. There are six different types of objects:
  395.  
  396.  
  397. Exec objects
  398. =============
  399.  
  400.    Exec objects describe programs which are started by ToolManager.
  401. Three different types of programs are supported: CLI, Workbench and
  402. ARexx. Each Exec object has the following parameters. The defaults are
  403. set in parantheses:
  404.  
  405. `Arguments' (Yes)
  406.      This switch controls the handing over of arguments to the program.
  407.      If a program doesn't support arguments or doesn't need them, you
  408.      can switch off the argument passing.
  409.  
  410. `Command'
  411.      The file name of the program to start. This name may be relative
  412.      to the current directory.
  413.  
  414. `Current Directory' (`SYS:')
  415.      The name of the current directory for the program. Note: ARexx
  416.      programs ignore this parameter.
  417.  
  418. `Delay' (0)
  419.      After activation of an Exec object, ToolManager waits `Delay'
  420.      seconds before it starts the program. If this value is negative,
  421.      the program will be started every `Delay' seconds. To stop an Exec
  422.      object which is waiting for execution, just activate it again.
  423.      Note: If `Delay' is set, the program will be started without
  424.      arguments.
  425.  
  426. `Exec Type' (CLI)
  427.      This specifies the type of the program. It can be one of: CLI, WB
  428.      or ARexx.
  429.  
  430. `Hot Key'
  431.      You can set a Hot Key for each Exec object. If this Hot Key event
  432.      is generated, the program will be started. Note: The program will
  433.      be started with no arguments.
  434.  
  435. `Output File' (`NIL:')
  436.      This is the file name of the output file. This is only useful for
  437.      CLI programs.
  438.  
  439. `Path' (path from ToolManager process)
  440.      This string sets the command search path for the program. You can
  441.      specify several directories by seperating the names with a ";".
  442.      This is only useful for CLI programs.
  443.  
  444. `Priority' (0)
  445.      This sets the priority of the new process which runs the program.
  446.  
  447. `Public Screen' (default public screen)
  448.      You can set the name of the public screen which should be moved to
  449.      front before the program is started. This only works in
  450.      conjunction with the `To Front' parameter.
  451.  
  452. `Stack' (4096)
  453.      This sets the stack size of the new process which runs the program.
  454.  
  455. `To Front' (No)
  456.      If you set this parameter the public screen specified by `Public
  457.      Screen' is moved to front before the program is started.
  458.  
  459.  
  460. Image objects
  461. ==============
  462.  
  463.    Image objects specify the image data which is used by ToolManager
  464. for icons or docks. This object type has only one parameter:
  465.  
  466. `File Name'
  467.      This specifies the name of the file from which ToolManager should
  468.      read the image data. ToolManager tries to detect the type of image
  469.      data automatically:
  470.  
  471.        1. It tries to load it as IFF data. Currently ToolManager can
  472.           read ILBM (one image) or ANIM (two or more images) files.
  473.  
  474.        2. It tries to read in an icon file. An icon can have one or two
  475.           images.
  476.  
  477.    Animations are currently only supported by Dock objects. Icon
  478. objects only retrieve the first and the second image from the animation
  479. to build a two image icon. If you want to make an animation for
  480. ToolManager, you should follow these design rules:
  481.  
  482. Image 1
  483.      This should be an image which represents the inactive state.
  484.  
  485. Image 2
  486.      This should be an image which represents the selected state.
  487.      Normally this is an inverted copy of the first image.
  488.  
  489. Image 3 to N-1
  490.      These are the images for the animation. Each image will be shown
  491.      for 1/3 of a second.
  492.  
  493. Image N
  494.      The last picture of the animation will be shown one second. After
  495.      this the first picture will be shown again.
  496.  
  497.  
  498. Sound objects
  499. ==============
  500.  
  501.    A Sound object can be used to make ToolManager noisy. ToolManager
  502. itself has no ability builtin to play sound data, it uses ARexx to
  503. activate an external sound player daemon. This object type has two
  504. parameters:
  505.  
  506. `Command'
  507.      This sets the ARexx command which ToolManager sends to activate
  508.      the external sound player. For `upd' this could be something like
  509.      `file samples:boing' which instructs `upd' to play the IFF sample
  510.      `samples:boing'. See Goodies.
  511.  
  512. `ARexx Port'
  513.      This specifies the ARexx port where ToolManager should send
  514.      `command' to. The default is `PLAY' which is the port for the
  515.      program `upd'.
  516.  
  517.  
  518. Menu objects
  519. =============
  520.  
  521.    Menu objects control the entries in the Workbench Tools menu. The
  522. object name is used as the menu text. To activate such an object, just
  523. select the menu entry. Menu objects only work when the Workbench is
  524. running.
  525.  
  526.    This object type has two parameters:
  527.  
  528. `Exec Object'
  529.      This is the name of an Exec object which should be activated when
  530.      the menu entry is selected. Every icon which is selected at this
  531.      time will be used as an argument for the program.
  532.  
  533. `Sound Object'
  534.      This is the name of a Sound object which should be activated when
  535.      the menu entry is selected.
  536.  
  537.    Note to ToolManager 1.X users: To simulate the old tool type "Dummy"
  538. just create a Menu object and specify *no* Exec and Sound object.
  539.  
  540.  
  541. Icon objects
  542. =============
  543.  
  544.    Icon objects describe application icons in the Workbench window.
  545. Such an object can be activated by double-clicking the icon or by
  546. dropping some icons on the application icon. Icon objects only work
  547. when the Workbench is running.
  548.  
  549.    The parameters for this object type are as follows:
  550.  
  551. `Exec Object'
  552.      This is the name of an Exec object which should be activated when
  553.      the icon is selected. Every icon which is dropped on the
  554.      application icon will be used as an argument for the program.
  555.  
  556. `Image Object'
  557.      This is the name of an Image object. The image data of this object
  558.      is used to build the application icon.
  559.  
  560. `Left Edge' (default: 0)
  561.      This sets the left edge for the application icon.
  562.  
  563. `Show Name' (default: Yes)
  564.      If this parameter is set, the object name will be used as the name
  565.      for the application icon.
  566.  
  567. `Sound Object'
  568.      This is the name of a Sound object which should be activated when
  569.      the icon is selected.
  570.  
  571. `Top Edge' (default: 0)
  572.      This sets the top edge for the application icon.
  573.  
  574.    Note: The Workbench is *very* picky about the position of icons. If
  575. you specify coordinates which the Workbench doesn't like, it will
  576. ignore them and place the icon somewhere else.
  577.  
  578.  
  579. Dock objects
  580. =============
  581.  
  582.    Dock objects describe windows. These windows combine several tools
  583. which are represented by images or gadgets. To start such a tool just
  584. click on its image or gadget. Of course you can drop some icons on the
  585. image or gadget to supply arguments for the tool.
  586.  
  587.    Each dock object has several parameters. The defaults are set in
  588. parentheses:
  589.  
  590. `Activated' (Yes)
  591.      A dock window can be active (open) or unactive (closed).
  592.  
  593. `Centered' (No)
  594.      If this parameter is set, the window will always be centered to
  595.      the current mouse position when it opens.
  596.  
  597. `Columns' (1)
  598.      This parameter sets the the number of tool columns. Tools are
  599.      always sorted row-wise, starting at the leftmost column and
  600.      filling up to the rightmost column.
  601.  
  602. `Font' (Screen font)
  603.      If you have a dock window with the parameter `Text' set, you can
  604.      choose the font for the button gadgets with this parameter.
  605.  
  606. `Frontmost' (No)
  607.      If you set this parameter, the dock window will always open on the
  608.      frontmost public screen.
  609.  
  610. `Hot Key'
  611.      You can set a Hot Key for each Dock object. If this Hot Key event
  612.      is generated, the activation status of the dock window will be
  613.      toggled; that is it will be closed or opened.
  614.  
  615. `Left Edge' (0)
  616.      This parameter sets the left edge of the dock window. If the
  617.      parameter `Centered' is set, this parameter will be ignored.
  618.  
  619. `Menu' (No)
  620.      You can add a small menu to each dock window. This menu has two
  621.      items:
  622.  
  623.         * `Close Dock' Close dock window.
  624.  
  625.         * `Quit TM' Quit ToolManager
  626.  
  627. `Pattern' (No)
  628.      The dock window automatically adjusts its size to the largest
  629.      image. Each dock entry has the same size, and smaller images are
  630.      centered, so they have a blank border around them. If you don't
  631.      like this blank border, set this parameter and the border will be
  632.      filled with a pattern.
  633.  
  634. `PopUp' (No)
  635.      When this parameter is set the dock window will be closed
  636.      automatically after selecting one dock entry. This is especially
  637.      useful in conjunction with the parameters `Centered', `Frontmost'
  638.      and a Hot Key of the class `rawmouse' (see Hot Keys).
  639.  
  640. `Public Screen' (Default public screen)
  641.      Specifies the public screen on which the dock window should open.
  642.      If the dock window was opened via Hot Key, the public screen will
  643.      be moved to front after the window has been opened. This parameter
  644.      will be ignored if the parameter `Frontmost' is set.
  645.  
  646. `Text' (No)
  647.      You can choose between images and button gadgets in dock windows
  648.      with this parameter. Button dock windows are especially useful
  649.      when used in conjunction with the parameter `PopUp'.
  650.  
  651. `Title'
  652.      This specifies the dock window title. If you supply a title, the
  653.      dock window will be a normal OS 2.0 window with dragbar, close
  654.      gadget, depth gadget and a border. If you *don't* supply a title,
  655.      you will get a dock window with only a dragbar and *no* border.
  656.  
  657. `Top Edge' (0)
  658.      This parameter sets the top edge of the dock window. If the
  659.      parameter `Centered' is set, this parameter will be ignored.
  660.  
  661. `Vertical' (No)
  662.      If the dock window has the new window design (that is: only a
  663.      dragbar and no border), this parameter sets the orientation of the
  664.      dragbar. This parameter is ignored if you supplied a window title
  665.      with the parameter `Title'.
  666.  
  667.  
  668. The ToolManager preferences editor
  669. ***********************************
  670.  
  671.    With the preferences editor you can manage the global configuration
  672. of ToolManager. This configuration gets automatically loaded when you
  673. start ToolManager. To start the editor just double click its icon. You
  674. will then see the main window.
  675.  
  676.  
  677. Main window gadgets
  678. ====================
  679.  
  680.    The main window has several groups of gadgets:
  681.  
  682. Object type
  683.      With this cycle gadget you can choose the type of objects that you
  684.      want to create or edit.
  685.  
  686. Object list
  687.      This gadget shows the list of all objects of the current type. You
  688.      can select an object by clicking on its name. If you double-click
  689.      one item, an edit window will open.
  690.  
  691. Move object
  692.      When an object is selected, you can move it around in the list
  693.      with these gadgets. If you click on the `Sort' gadget, the items
  694.      in the list will be sorted alphabetically.
  695.  
  696. Manipulate object
  697.      These gadgets manipulate objects. The `New' gadget creates a new
  698.      object of the current type which is selected automatically. When
  699.      you click on the `Edit' gadget, an edit window for the selected
  700.      object will open. With the `Copy' gadget you can make a copy of
  701.      the selected object. The `Remove' gadget deletes the selected
  702.      object.
  703.  
  704. Configuration
  705.      You have several choices to save the configuration. With the `Save'
  706.      gadget you can save the configuration permanently into the file
  707.      `ENVARC:ToolManager.prefs'. For a temporary change use the `Use'
  708.      gadget, which will save the configuration into the file
  709.      `ENV:ToolManager.prefs'. This file will not survive a machine
  710.      reset. To test the new configuration without leaving the editor,
  711.      use the `Test' gadget. The `Cancel' gadget will quit the editor
  712.      without saving.
  713.  
  714.  
  715. Main window menus
  716. ==================
  717.  
  718.    The main window has several menu items:
  719.  
  720. `Project'
  721.      With the menu items `Open' and `Save As' you can load and save the
  722.      configuration. The `About' item opens an information requester.
  723.      Selecting the `Quit' item will leave the editor without saving.
  724.  
  725. `Edit'
  726.      With these menu items you can restore older configurations. The
  727.      `Last Saved' item loads the last saved configuration from the file
  728.      `ENVARC:ToolManager.prefs'. With the item `Restore' you can load
  729.      the configuration that was active before you started the editor
  730.      from the file `ENV:ToolManager.prefs'.
  731.  
  732. `Settings'
  733.      You can choose with the `Create Icons' item wether the menu item
  734.      `Save As' should create an icon or not.
  735.  
  736.  
  737. Edit windows
  738. =============
  739.  
  740.    Each object type has a different edit window to set the object
  741. parameters. For a detailed list of all object parameters see Objects.
  742.  
  743.    Every edit window has a string gadget for the object name. This name
  744. is important, because it is used to reference this object. Note that
  745. there is currently no builtin cross-reference. So if you change the
  746. name of an object which is already referenced by another object, this
  747. reference will *not* be updated. You have to update this reference by
  748. hand.
  749.  
  750.    The button gadgets in the edit windows open different types of
  751. requesters. You can choose an item by clicking on it and pressing the
  752. `OK' gadget, or you simply double-click it. To leave a requester
  753. without changes, use the `Cancel' gadget. If you wish to clear a field
  754. which can only be choosen by a requester, open the requester and press
  755. the `OK' gadget *without* selecting an item.
  756.  
  757.    The edit windows for the object types Exec and Image have an
  758. additional feature. You can simply drop an icon on them to set the
  759. parameters from this icon.
  760.  
  761.  
  762. Tooltypes
  763. ==========
  764.  
  765.    When you start the preferences editor from the Workbench you can set
  766. several tooltypes in the program icon or configuration file icons to
  767. control it.
  768.  
  769. `USE'
  770.      If you set this tooltype in an icon for a preferences file, the
  771.      editor will install this file as current configuration file.
  772.  
  773. `SAVE'
  774.      If you set this tooltype in an icon for a preferences file, the
  775.      editor will install this file as current and as permanent
  776.      configuration file.
  777.  
  778. `PUBSCREEN'
  779.      This tooltype tells the editor to open its windows on a specific
  780.      public screen. If you don't supply this tooltype, the default
  781.      public screen will be used.
  782.  
  783. `CREATEICONS'
  784.      When this tooltype is set to `YES', the editor will create an icon
  785.      for every preferences file that is created with the `Save As' menu
  786.      item.
  787.  
  788. `DEFAULTFONT'
  789.      The editor normally uses the public screen font to draw its
  790.      gadgets. If you set this tooltype to `YES', the editor will use
  791.      the system default font instead.
  792.  
  793.  
  794. CLI Arguments
  795. ==============
  796.  
  797.    When the preferences editor is started from the shell, it uses the
  798. following command line template:
  799.  
  800.      FROM,EDIT/S,USE/S,SAVE/S,PUBSCREEN/K,DEFAULTFONT/S
  801.  
  802. `FROM'
  803.      This parameter specifies the name of the preferences file which
  804.      the editor should load.
  805.  
  806. `USE'
  807.      If you use this parameter, the editor will install the file
  808.      specified as the `FROM' parameter as current configuration file.
  809.  
  810. `SAVE'
  811.      If you use this parameter, the editor will install the file
  812.      specified as the `FROM' parameter as current and as permanent
  813.      configuration file.
  814.  
  815. `PUBSCREEN'
  816.      This parameter tells the editor to open its windows on a specific
  817.      public screen. If you don't supply this tooltype the default
  818.      public screen will be used.
  819.  
  820. `DEFAULTFONT'
  821.      The editor normally uses the public screen font to draw its
  822.      gadgets. If you use this parameter the editor will use the system
  823.      default font instead.
  824.  
  825.  
  826. The ToolManager shared library interface
  827. *****************************************
  828.  
  829.    The ToolManager handler is embedded into a Amiga shared library.
  830. This library offers several functions to create and manipulate
  831. ToolManager objects, so that you can use them in your programs.
  832.  
  833.    There are currently six functions available:
  834.  
  835. `AllocTMHandle()'
  836.      In order to create ToolManager objects you must first allocate a
  837.      TMHandle. This handle stores all information about your objects
  838.      and is used to reference them. Note that the information stored in
  839.      this handle is *only* accessable by the program which creates it.
  840.  
  841. `FreeTMHandle()'
  842.      This function frees a TMHandle and all ToolManager objects
  843.      associated with it. Each `AllocTMHandle()' must be matched with a
  844.      `FreeTMHandle()'!
  845.  
  846. `CreateTMObjectTags()'
  847. `CreateTMObjectTagList()'
  848.      This function creates a ToolManager object. You must supply a
  849.      name, the object type and various tags for the object parameters.
  850.      The name of the object is important, as it is used to reference
  851.      the object.
  852.  
  853. `ChangeTMObjectTags()'
  854. `ChangeTMObjectTagList()'
  855.      You can modify the parameters of a ToolManager object with this
  856.      function. The object state will be updated to reflect the new
  857.      parameters. Note: Currently Image objects can't be modified.
  858.  
  859. `DeleteTMObject()'
  860.      With this function you can delete a ToolManager object. If the
  861.      object is linked to other objects, these objects will be notified
  862.      to update their state.
  863.  
  864. `QuitToolManager()'
  865.      This function tells the ToolManager handler to quit as soon as
  866.      possible.
  867.  
  868.    The complete library interface description is available in AutoDoc
  869. format (see Docs).
  870.  
  871.  
  872. How to define a Hot Key
  873. ************************
  874.  
  875.    This chapter describes how to define a Hot Key as an Input
  876. Description String, which is then parsed by Commodities. Each time a
  877. Hot Key is activated Commodities generates an event which is used by
  878. ToolManager to activate Exec objects or to toggle Dock objects. A
  879. description string has the following syntax:
  880.  
  881.      [<class>] {[-][<qualifier>]} [-][upstroke] [<key code>]
  882.  
  883.    All keywords are case insensitive.
  884.  
  885.    `class' describes the InputEvent class. This parameter is optional
  886. and if it is missing the default `rawkey' is used. See InputEvent
  887. classes.
  888.  
  889.    Qualifiers are "signals" that must be set or cleared by the time the
  890. Hot Key is activated; otherwise no event will be generated. For each
  891. qualifier that must be set you supply its keyword. All other qualifiers
  892. are expected to be cleared by default. If you want to ignore a
  893. qualifier, just set a `-' before its keyword. See Qualifiers.
  894.  
  895.    Normally a Hot Key event is generated when a key is pressed. If the
  896. event should be generated when the key is released, supply the keyword
  897. `upstroke'. When both press and release of the key should generate an
  898. event, use `-upstroke'.
  899.  
  900.    The key code is depending on the InputEvent class. See Key codes.
  901.  
  902.    Note: Choose your hot keys *carefully*, because Commodities has a
  903. high priority in the InputEvent handler chain (i.e. will override
  904. existing definitions).
  905.  
  906.  
  907. InputEvent classes
  908. ===================
  909.  
  910.    Commodities supports most of the InputEvent classes that are
  911. generated by the input.device. This section describes those classes
  912. that are most useful for ToolManager Hot Keys.
  913.  
  914. `rawkey'
  915.      This is the default class and covers all keyboard events. For
  916.      example `rawkey a' or `a' creates an event every time when the key
  917.      "a" is pressed. You must specify a key code for this class. See
  918.      rawkey key codes.
  919.  
  920. `rawmouse'
  921.      This class describes all mouse button events. You must specify a
  922.      key code for this class. See rawmouse key codes.
  923.  
  924. `diskinserted'
  925.      Events of this class are generated when a disk is inserted in a
  926.      drive. This class has no key codes.
  927.  
  928. `diskremoved'
  929.      Events of this class are generated when a disk is removed from a
  930.      drive. This class has no key codes.
  931.  
  932.  
  933. Qualifiers
  934. ===========
  935.  
  936.    Some keyword synonyms were added to Commodities V38. These are
  937. marked with an `*'.
  938.  
  939. `lshift', `left_shift' *
  940.      Left shift key.
  941.  
  942. `rshift', `right_shift' *
  943.      Right shift key.
  944.  
  945. `shift'
  946.      Either shift key.
  947.  
  948. `capslock', `caps_lock' *
  949.      Caps lock key.
  950.  
  951. `caps'
  952.      Either shift key or caps lock key.
  953.  
  954. `control', `ctrl' *
  955.      Control key.
  956.  
  957. `lalt', `left_alt' *
  958.      Left alt key.
  959.  
  960. `ralt', `right_alt' *
  961.      Right alt key.
  962.  
  963. `alt'
  964.      Either alt key.
  965.  
  966. `lcommand', `lamiga' *, `left_amiga' *, `left_command' *
  967.      Left Amiga/Command key.
  968.  
  969. `rcommand', `ramiga' *, `right_amiga' *, `right_command' *
  970.      Right Amiga/Command key.
  971.  
  972. `numericpad', `numpad' *, `num_pad' *, `numeric_pad' *
  973.      This keyword *must* be used for any key on the numeric pad.
  974.  
  975. `leftbutton', `lbutton' *, `left_button' *
  976.      Left mouse button. See note below.
  977.  
  978. `midbutton', `mbutton' *, `middlebutton' *, `middle_button' *
  979.      Middle mouse button. See note below.
  980.  
  981. `rbutton', `rightbutton' *, `right_button' *
  982.      Right mouse button. See note below.
  983.  
  984. `repeat'
  985.      This qualifier is set when the keyboard repeat is active. Only
  986.      useful for InputEvent class `rawkey'.
  987.  
  988.    Note: Commodities V37 has a bug which prevents the use of
  989. `leftbutton', `midbutton' and `rbutton' as qualifiers. This bug is
  990. fixed in V38.
  991.  
  992.  
  993. Key codes
  994. ==========
  995.  
  996.    Each InputEvent class has its own key codes:
  997.  
  998.  
  999. Key codes for InputEvent class `rawkey'
  1000. ----------------------------------------
  1001.  
  1002.    Some keywords and synonyms were added to Commodities V38. These are
  1003. marked with an `*'.
  1004.  
  1005. `a'-`z', `0'-`9', ...
  1006.      ASCII characters.
  1007.  
  1008. `f1', `f2', ..., `f10', `f11' *, `f12' *
  1009.      Function keys.
  1010.  
  1011. `up', `cursor_up' *, `down', `cursor_down' *
  1012. `left', `cursor_left' *, `right', `cursor_right' *
  1013.      Cursor keys.
  1014.  
  1015. `esc', `escape' *, `backspace', `del', `help'
  1016. `tab', `comma', `return', `space', `spacebar' *
  1017.      Special keys.
  1018.  
  1019. `enter', `insert' *, `delete' *
  1020. `page_up' *, `page_down' *, `home' *, `end' *
  1021.      Numeric Pad keys. Each of these key codes *must* be used with the
  1022.      `numericpad' qualifier keyword!
  1023.  
  1024.  
  1025. Key codes for InputEvent class `rawmouse'
  1026. ------------------------------------------
  1027.  
  1028.    These keywords were added to Commodities V38. They are not available
  1029. in V37.
  1030.  
  1031. `mouse_leftpress'
  1032.      Press left mouse button.
  1033.  
  1034. `mouse_middlepress'
  1035.      Press middle mouse button.
  1036.  
  1037. `mouse_rightpress'
  1038.      Press right mouse button.
  1039.  
  1040.    Note: To use one of these key codes, you must also set the
  1041. corresponding qualifier keyword, e.g.
  1042.  
  1043.      rawmouse leftbutton mouse_leftpress
  1044.  
  1045.  
  1046. Examples for Hot Keys
  1047. ======================
  1048.  
  1049. `ralt t'
  1050.      Hold right Alt key and press "t"
  1051.  
  1052. `ralt lalt t'
  1053.      Hold left *and* right Alt key and press "t"
  1054.  
  1055. `alt t'
  1056.      Hold either Alt key and press "t"
  1057.  
  1058. `rcommand f2'
  1059.      Hold right Amiga key and press the second function key
  1060.  
  1061. `numericpad enter'
  1062.      Press the Enter key on the numeric pad
  1063.  
  1064. `rawmouse midbutton leftbutton mouse_leftpress'
  1065.      Hold middle mouse button and press the the left mouse button
  1066.  
  1067. `diskinserted'
  1068.      Insert a disk in any drive.
  1069.  
  1070.  
  1071. The History of ToolManager
  1072. ***************************
  1073.  
  1074. 2.0, Release date 26.09.1992
  1075.         - Complete new concept (object oriented)
  1076.  
  1077.         - (Almost) Complete rewrite
  1078.  
  1079.         - ToolManager is now split up into two parts
  1080.  
  1081.         - Main handler is now embedded into a shared library
  1082.  
  1083.         - Configuration is now handled by a Preferences program
  1084.  
  1085.         - Configuration file format has changed again :-) It is an IFF
  1086.           File now and resides in ENV:
  1087.  
  1088.         - Multiple Docks and multi-column Docks
  1089.  
  1090.         - Docks with new window design
  1091.  
  1092.         - Dock automatically detects largest image size
  1093.  
  1094.         - Sound support
  1095.  
  1096.         - Direct ARexx support for Exec objects
  1097.  
  1098.         - ToolManager can be used without the Workbench. If the
  1099.           Workbench isn't running, it won't use any App* features.
  1100.  
  1101.         - Locale support
  1102.  
  1103.         - Path from Workbench will be used for CLI tools
  1104.  
  1105.         - Seperate Handler Task for starting WB processes
  1106.  
  1107. 1.5, Release date 10.10.1991, Fish Disk #551
  1108.         - Status Window: New/Open/Append/Save As menu items for config
  1109.           file
  1110.  
  1111.         - Edit Window: File requesters for file string gadgets
  1112.  
  1113.         - Added a Dock Window (a la NeXT)
  1114.  
  1115.         - Added a DeleteTool
  1116.  
  1117.         - A list of all active HotKeys can be shown
  1118.  
  1119.         - Tools can be moved around in the list
  1120.  
  1121.         - Icon positioning in the edit window added
  1122.  
  1123.         - Name of the program icon can be set
  1124.  
  1125.         - CLI tools can have an output file and a path list
  1126.  
  1127.         - Uses UserShell for CLI tools
  1128.  
  1129.         - Maximum command line length for CLI tools is now 4096 Bytes
  1130.  
  1131.         - AppIcons without a name are supported now
  1132.  
  1133.         - Workbench screen will be moved to front if you pop up the
  1134.           Status window
  1135.  
  1136.         - Workbench screen can be moved to front before starting a tool
  1137.           via HotKey
  1138.  
  1139.         - TM will wait up to 20 seconds for the workbench.library
  1140.  
  1141.         - Added a DELAY switch which causes TM to wait <num> seconds
  1142.           before adding any App* stuff
  1143.  
  1144.         - renamed some tooltypes/parameters
  1145.  
  1146.         - some visual cues added
  1147.  
  1148.         - some internal changes
  1149.  
  1150. 1.4, Release date 09.07.1991, Fish Disk #527
  1151.         - Keyboard short cuts for tools
  1152.  
  1153.         - AppIcons for tools
  1154.  
  1155.         - Menu item can be switched off
  1156.  
  1157.         - Configuration file format completely changed (hopefully the
  1158.           last time)
  1159.  
  1160.         - CLI commandline parsing is now done by ReadArgs()
  1161.  
  1162.         - Status & edit window updated to new features
  1163.  
  1164.         - Safety check before program shutdown added
  1165.  
  1166.         - Menu item "Open TM Window" only appears if the program icon is
  1167.           disabled
  1168.  
  1169.         - WB startup method changed. Now supports project icons
  1170.  
  1171.         - several internal changes
  1172.  
  1173. 1.3, Release date 13.03.1991, Fish Disk #476
  1174.         - Now supports different configuration files
  1175.  
  1176.         - Format of the configuration file slightly changed
  1177.  
  1178.         - Tool definitions can be changed at runtime
  1179.  
  1180.         - Now supports CLI & Workbench startup method
  1181.  
  1182.         - Selected icons are passed as parameters to the tools
  1183.  
  1184.         - Now uses the startup icon as program icon if started from
  1185.           Workbench
  1186.  
  1187.         - The position of the icon can now be supplied in the
  1188.           configuration file
  1189.  
  1190.         - The program icon can now be disabled
  1191.  
  1192.         - New menu entry "Show TM Window"
  1193.  
  1194.         - Every new started ToolManager passes its startup parameters
  1195.           to the already running ToolManager process
  1196.  
  1197. 1.2, Release date 12.01.1991, Fish Disk #442
  1198.         - Status window changed to a no-GZZ & simple refresh type (this
  1199.           should save some bytes)
  1200.  
  1201.         - Status window remembers its last position
  1202.  
  1203.         - New status window gadget "Save Configuration": saves the
  1204.           actual tool list in the configuration file
  1205.  
  1206.         - Small bugs removed in the ListView gadget handling
  1207.  
  1208.         - Name of the icon hard-wired to "ToolManager"
  1209.  
  1210. 1.1, Release date 01.01.1991
  1211.         - Icons can be dropped on the status window
  1212.  
  1213.         - Status window contains a list of all tool names
  1214.  
  1215.         - Tools can be removed from the list
  1216.  
  1217. 1.0, Release date 04.11.1990
  1218.         - Initial release
  1219.  
  1220.  
  1221. The author would like to thank...
  1222. **********************************
  1223.  
  1224.    ToolManager has gone through many major evolutionary phases since
  1225. its first implementation in mid-1990. This development would have been
  1226. impossible if I hadn't received the enormous feedback from various
  1227. ToolManager users. Many ideas & features resulted from this source...
  1228.  
  1229.    Therefore I would like to thank:
  1230.  
  1231. For Alpha/Beta testing, ideas & bug reports:
  1232.      Amiga section of our local computer club (Computerclub an der RWTH
  1233.      Aachen), Olaf 'Olsen' Barthel, Georg Hessmann (Gucky), Markus
  1234.      Illenseer (ill), Klaus Melchior, Rickard Olsson (Richie), Matthias
  1235.      Scheler (Tron), Ralph Schmidt (laire), Roger Westerlund (Budda),
  1236.      Juergen Weinelt, Brian Wright (SteveVai), Petra Zeidler
  1237.      (stargazer) and many others...
  1238.  
  1239. Matthew Dillon
  1240.      Without your *excellent* C development system DICE and various
  1241.      other tools, ToolManager wouldn't exist!
  1242.  
  1243. For their excellent graphics work:
  1244.      Andreas Harrenberg, Georg Hessmann, Michael "Mick" Hohmann, Markus
  1245.      Illenseer, Oliver Koenen, Klaus Melchior, Rickard Olsson, Jan
  1246.      Peter, Matthias Scheler, Brian Wright
  1247.  
  1248. For the Locale translations:
  1249.      Tomi Blinnikka (Finnish), Dr. Peter Kittel (German), Klaus Melchior
  1250.      (Eifel Platt), Rickard Olsson (Swedish), Marc Schaefer (French &
  1251.      Italiano)
  1252.  
  1253. All gals & guys at West Chester:
  1254.      For developing the Amiga and its superb operating system.
  1255.  
  1256. All users who sent me money:
  1257.      I didn't ask for it in the 1.X releases, but it's nice to see when
  1258.      someone appreciates my work.
  1259.  
  1260. All users who sent me a note:
  1261.      I really enjoyed reading your letters!
  1262.  
  1263. and all I forgot to mention...
  1264.  
  1265. Index
  1266. ******
  1267.  
  1268.  
  1269.  
  1270.  TeX                                    Docs
  1271.  ARexx scripts                          Scripts
  1272.  ASCII documentation                    Docs
  1273.  Address                                Authors address
  1274.  AmigaGuide                             Docs
  1275.  Bug reports                            Authors address
  1276.  CLI Arguments                          CLI Arguments
  1277.  Catalog files                          Locale
  1278.  Comments                               Authors address
  1279.  Compiler support                       Programmers
  1280.  Concepts                               Concepts
  1281.  Configuration                          Preferences
  1282.  Contributed images                     Graphics
  1283.  Copyright                              Copyright
  1284.  Credits                                Credits
  1285.  DeleteTool                             Goodies
  1286.  Diskinserted                           InputEvent classes
  1287.  Diskremoved                            InputEvent classes
  1288.  Distribution                           Copyright
  1289.  Distribution files                     Distribution files
  1290.  Dock objects                           Dock
  1291.  Docs directory                         Docs
  1292.  Documentation                          Docs
  1293.  Donations                              Authors address
  1294.  E-Mail                                 Authors address
  1295.  Example images                         Graphics
  1296.  Examples for Hot Keys                  Hot Key examples
  1297.  Exec objects                           Exec
  1298.  Fast installation                      Quick installation
  1299.  GetPubName                             Goodies
  1300.  GiftWare                               Important
  1301.  Goodies directory                      Goodies
  1302.  Graphics directory                     Graphics
  1303.  History                                History
  1304.  Hot Keys                               Hot Keys
  1305.  Icon objects                           Icon
  1306.  Image objects                          Image
  1307.  Important notes                        Important
  1308.  InputEvent classes                     InputEvent classes
  1309.  Installation (quick)                   Quick installation
  1310.  InterNet address                       Authors address
  1311.  Introduction to Hot Keys               Hot Keys
  1312.  Introduction to ToolManager            Introduction
  1313.  Introduction to ToolManager objects    Concepts
  1314.  Key codes for rawkey                   rawkey key codes
  1315.  Key codes for rawmouse                 rawmouse key codes
  1316.  L directory                            L
  1317.  Language files                         Locale
  1318.  Languages                              Locale
  1319.  Legal stuff                            Copyright
  1320.  Library documentation                  Docs
  1321.  Library interface                      Library
  1322.  Libs directory                         Libs
  1323.  List: rawkey key codes                 rawkey key codes
  1324.  List: rawmouse key codes               rawmouse key codes
  1325.  List: Qualifiers                       Qualifiers
  1326.  Locale directory                       Locale
  1327.  Localization                           Locale
  1328.  Menu objects                           Menu
  1329.  Objects                                Objects
  1330.  Permissions                            Copyright
  1331.  Postal address                         Authors address
  1332.  Preferences editor                     Preferences
  1333.  Prefs directory                        Prefs
  1334.  Printed documentation                  Docs
  1335.  Probibitions                           Copyright
  1336.  Program concepts                       Concepts
  1337.  Programm versions                      History
  1338.  Programmers directory                  Programmers
  1339.  Qualifiers                             Qualifiers
  1340.  Quick installation                     Quick installation
  1341.  Rawkey                                 InputEvent classes
  1342.  Rawmouse                               InputEvent classes
  1343.  Reference: Distribution files          Distribution files
  1344.  Reference: Hot Keys                    Hot Keys
  1345.  Reference: Library interface           Library
  1346.  Reference: Preferences editor          Preferences
  1347.  Reference: ToolManager objects         Objects
  1348.  Scripts directory                      Scripts
  1349.  Shared library interface               Library
  1350.  Shell scripts                          Scripts
  1351.  Sound objects                          Sound
  1352.  Sound player                           Goodies
  1353.  Source code                            Source
  1354.  Source directory                       Source
  1355.  Texinfo                                Docs
  1356.  Thanks                                 Credits
  1357.  ToolManager objects                    Objects
  1358.  ToolManager shared library interface   Library
  1359.  Tooltypes                              Tooltypes
  1360.  Translations                           Locale
  1361.  Translators                            Source
  1362.  UPD                                    Goodies
  1363.  V38 features                           Important
  1364.  Versions                               History
  1365.  WBStart 1.2                            L
  1366.  WBStart-Handler                        L
  1367.  WBStartup directory                    WBStartup
  1368.  
  1369.